home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / dlassq.z / dlassq
Encoding:
Text File  |  1998-10-30  |  2.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. DDDDLLLLAAAASSSSSSSSQQQQ((((3333FFFF))))                                                          DDDDLLLLAAAASSSSSSSSQQQQ((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DLASSQ - return the values scl and smsq such that   ( scl**2 )*smsq = x(
  10.      1 )**2 +...+ x( n )**2 + ( scale**2 )*sumsq,
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE DLASSQ( N, X, INCX, SCALE, SUMSQ )
  14.  
  15.          INTEGER        INCX, N
  16.  
  17.          DOUBLE         PRECISION SCALE, SUMSQ
  18.  
  19.          DOUBLE         PRECISION X( * )
  20.  
  21. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  22.      DLASSQ  returns the values  scl  and  smsq  such that
  23.  
  24.      where  x( i ) = X( 1 + ( i - 1 )*INCX ). The value of  sumsq  is assumed
  25.      to be non-negative and  scl  returns the value
  26.  
  27.         scl = max( scale, abs( x( i ) ) ).
  28.  
  29.      scale and sumsq must be supplied in SCALE and SUMSQ and
  30.      scl and smsq are overwritten on SCALE and SUMSQ respectively.
  31.  
  32.      The routine makes only one pass through the vector x.
  33.  
  34.  
  35. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  36.      N       (input) INTEGER
  37.              The number of elements to be used from the vector X.
  38.  
  39.      X       (input) DOUBLE PRECISION
  40.              The vector for which a scaled sum of squares is computed.  x( i )
  41.              = X( 1 + ( i - 1 )*INCX ), 1 <= i <= n.
  42.  
  43.      INCX    (input) INTEGER
  44.              The increment between successive values of the vector X.  INCX >
  45.              0.
  46.  
  47.      SCALE   (input/output) DOUBLE PRECISION
  48.              On entry, the value  scale  in the equation above.  On exit,
  49.              SCALE is overwritten with  scl , the scaling factor for the sum
  50.              of squares.
  51.  
  52.      SUMSQ   (input/output) DOUBLE PRECISION
  53.              On entry, the value  sumsq  in the equation above.  On exit,
  54.              SUMSQ is overwritten with  smsq , the basic sum of squares from
  55.              which  scl  has been factored out.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.